home *** CD-ROM | disk | FTP | other *** search
/ Games of Daze / Infomagic - Games of Daze (Summer 1995) (Disc 1 of 2).iso / x2ftp / msdos / utils / vgafed30 / feditor.doc < prev    next >
Text File  |  1994-03-28  |  12KB  |  258 lines
  1.  
  2.                                       
  3.                               Font Editor v3.0
  4.                               ~~~~~~~~~~~~~~~~
  5.                                       
  6.             Copyright 1992,1993 S.Griffiths, All Rights Reserved
  7.   
  8.   
  9.   
  10.   Introduction
  11.   ~~~~~~~~~~~~
  12.   This  is a font editor to edit the VGA font (yep, a REALLY useful  piece
  13.   of  software !). Once a font has been created, a TSR program or a Device
  14.   Driver can be created to allow the font to be loaded and remain resident
  15.   for  other  programs. Font Editor is definitely not crippled in  anyway,
  16.   and  you only have to put up with a shareware window poping up when  its
  17.   first loaded. The Device driver and TSR that can be created only require
  18.   an mere 4K.
  19.  
  20.   This  program is shareware and you are encouraged to pass  it  along  to
  21.   others.  If  you find the font editor useful (you never know,  it  could
  22.   happen)  then please send an registration fee of a mere $20  (N.Z.)  and
  23.   you  will get a copy of the registered version and it will allow  me  to
  24.   have a hot meal. Your comments and suggestions are most welcome.
  25.   
  26.   As well as the latest version the registered version includes the source
  27.   code  for the TSR (A86 Assembler source), the source code to the  device
  28.   driver  (TASM Assembler) and source example code for using your designed
  29.   fonts in Pascal, C, and Assembler.
  30.   
  31.   DISCLAIMER OF WARRANTY
  32.   ~~~~~~~~~~~~~~~~~~~~~~
  33.   
  34.   THIS  SOFTWARE  AND  MANUAL  ARE SUPPLIED "AS  IS".  THE  AUTHOR  HEREBY
  35.   DISCLAIMS ALL WARRANTIES RELATING TO THIS SOFTWARE AND ITS DOCUMENTATION
  36.   FILE,  EXPRESS  OR  IMPLIED, INCLUDING BUT  NOT  LIMITED  TO  DAMAGE  TO
  37.   HARDWARE,  SOFTWARE AND/OR DATA FROM USE OF THIS PRODUCT.  IN  NO  EVENT
  38.   WILL THE AUTHOR OF THIS SOFTWARE BE LIABLE TO YOU OR ANY OTHER PARTY FOR
  39.   ANY  DAMAGES. YOUR USE OF THIS SOFTWARE INDICATES THAT YOU HAVE READ AND
  40.   AGREE TO THESE AND OTHER TERMS INCLUDED IN THIS DOCUMENTATION FILE.
  41.   
  42.   DUE  TO THE NATURE OF EVOLVING PROGRAMMING AND THE VARIOUS HARDWARE  AND
  43.   SOFTWARE  ENVIRONMENTS  IN  WHICH THIS  SOFTWARE  MAY  BE  USED,  IT  IS
  44.   UNDERSTOOD  THAT  OCCASIONAL "BUGS" OR UNFITNESS  MAY  ARISE.  THE  USER
  45.   SHOULD  ALWAYS  TEST  THIS SOFTWARE THOROUGHLY  WITH  NON-CRITICAL  DATA
  46.   BEFORE RELYING ON IT.
  47.   
  48.   LICENSE
  49.   ~~~~~~~
  50.   
  51.   FEDITOR  is distributed as shareware. This means that you are granted  a
  52.   limited license to use it for a period of 30 days. If you find it useful
  53.   and decide to continue using it after the trial period, registration  is
  54.   required.  FEDITOR  is neither free software nor is  it  in  the  public
  55.   domain.  The software and its documentation, this file, are property  of
  56.   the  author  and  may  not be sold without written permission  from  the
  57.   author.
  58.   
  59.   Registered users will be granted a just-like-a-book license which  means
  60.   a registered version of the software can be used by more than one person
  61.   and  can  be moved from one computer to another so long as there  is  NO
  62.   POSSIBILITY  of it being used by two different persons on two  different
  63.   computers  at  the same time, just like a book can not be  read  by  two
  64.   different persons in two different places at the same time.
  65.   
  66.   A  dealer license allows you distribute as many copies of FEDITOR as you
  67.   like,  to  whomever  you  please, provided no charge  is  made  and  the
  68.   following distribution terms are met.
  69.   
  70.   TERMS OF DISTRIBUTION
  71.   ~~~~~~~~~~~~~~~~~~~~~
  72.   
  73.   Redistribution  of FEDITOR must include the software, its  documentation
  74.   file,  and  all  supplemental  files  as  a  single  unit  without   any
  75.   modification AND subject to the following conditions:
  76.   
  77.   1.Any  individual  is welcome to make copies for his/her friends  and/or
  78.     colleagues if NO FEE is charged.
  79.   
  80.   2.Electronic bulletin boards, whether they charge or do not charge their
  81.     users  subscription  fee, are welcome to post  the  program  for  down
  82.     loading  as long as they do not charge any fee in particular  for  the
  83.     distribution of FEDITOR.
  84.   
  85.   3.Non-commercial  user  groups and computer  clubs  may  distribute  the
  86.     program to their members if only a small distribution fee charged.
  87.   
  88.   4.Disk vendors approved by the Association of Shareware Professionals or
  89.     disk  vendors who explain the concept of shareware in their  ads  that
  90.     quote a price may distribute the shareware version of FEDITOR.
  91.   
  92.   5.Other  commercial  enterprises wishing to  distribute  FEDITOR  either
  93.     alone  or  in  combination  with other hardware,  software,  books  or
  94.     materials must obtain permission in writing from the author.
  95.   
  96.   HOW TO REGISTER
  97.   ~~~~~~~~~~~~~~~
  98.   
  99.   Please read this section before filling out the order form.
  100.   
  101.   1.   Read the License information (above)
  102.   
  103.   2.   Foreign order. Payment in the following forms is accepted:
  104.   
  105.             A.   Cash (Please note that the author cannot be responsible
  106.                  for any loss in the mail)
  107.             B.   Bank check.
  108.             C.   International money order issued by banks, etc...
  109.   
  110.   To  compensate the inconvenience of currency exchange, foreign users are
  111.   charged the same amount for shipping and handling as N.Z. users.
  112.   
  113.   
  114.   Using the Font Editor
  115.   ~~~~~~~~~~~~~~~~~~~~~
  116.  
  117.   The  file name of the font to edit can be specified on the command line,
  118.   otherwise the system font is used. To create a new font file specify the
  119.   file  name  and include a /S on the command line to get the  system  VGA
  120.   font.  Once  the  program is loaded there are three  main  windows:  the
  121.   current character being edited, the available ASCII characters, and  the
  122.   details about the current character. To move between the editing  window
  123.   and  the  ASCII chart use [TAB]. To indicate which window is active  the
  124.   border will change to a double line in the active window. The arrow keys
  125.   will  move  the highlite marker about. To change a pixel (while  in  the
  126.   character window) press [SPACE], and to select a new character (while in
  127.   the ASCII chart screen) press [ENTER].
  128.   
  129.   While moving about the ASCII chart window each characters ASCII value is
  130.   displayed in decimal, hex and binary.
  131.   
  132.   Edit Keys
  133.   ~~~~~~~~~
  134.   
  135.         F1 - Display help screen
  136.   
  137.         F2 - Save font file to disk (fnt), this over writes the
  138.              existing file, which is displayed at the bottom of the
  139.              screen. No backup is made.
  140.   
  141.         F3 - Erase current character (just blank it out).
  142.   
  143.   Shift+F3 - Fill current character (making it a solid block).
  144.   
  145.    Ctrl+F3 - Toggle current character, this will switch the pixels
  146.              around, making the character go into a reverse mode.
  147.   
  148.         F4 - Create a device driver for the current font, with the
  149.              same name as the current font. The device driver has
  150.              the extension SYS, to be loaded from the CONFIG.SYS
  151.              file with the DEVICE= command.
  152.   
  153.         F5 - As above but with the extension COM. This TSR can be
  154.              loaded from DOS to switch to the new font.
  155.   
  156.    Ctrl+F5 - Create TSR without initialising font, this does the
  157.              same as the above option, but the font isn't turned on
  158.              straight away. Once the VGA mode is reset the font
  159.              will be activated.
  160.   
  161.         F6 - This creates a file with the extension PAS, which is
  162.              which is suitable for importing into pascal programs.
  163.   
  164.         F7 - As above, but the format is for C programs, with the
  165.              extension being C.
  166.   
  167.         F8 - As [F6] but the extension will be ASM, and is suitable
  168.              for most assemblers.
  169.   
  170.         F9 - This replaces the current character, whether in the
  171.              ASCII window or editing window with the system font.
  172.   
  173.   Shift+F9 - Same as above but it gets all the system characters.
  174.   
  175.    Ctrl+F9 - Same as [F9] but uses the alternative font. If no
  176.              alternative font has been loaded then this can't be
  177.              done.
  178.   
  179.        F10 - This displays a window of .fnt files. The window
  180.              display can be toggled by pressing [SPACE]. Select the
  181.              file you wish to load with [ENTER].
  182.   
  183.   Ctrl+F10 - This loads an alternative font file, but the font
  184.              won't be displayed, and can be accessed with the
  185.              [Ctrl-F9] option.
  186.   
  187.          C - Copy character to buffer, this can only be done while
  188.              in the editing window.
  189.   
  190.          P - Paste character from buffer, if no character has been
  191.              previously copied then the pasted character will be
  192.              blank or garbage.
  193.   
  194.          H - Flip the current character horizontally.
  195.   
  196.          V - Flip the current character vertically.
  197.   
  198.   Using  Shift+Arrow keys while in the edit window will scroll the current
  199.   character about the box in the various directions.
  200.  
  201.   If  the  program is started with no parameters the system font  will  be
  202.   used and its file name will be default.fnt.
  203.   
  204.   A  small screen flicker will occur when changing a fonts pixel - this is
  205.   because  of  the interrupt updating the memory, depending on your  video
  206.   card the degree of flicker might vary.
  207.  
  208.  
  209.   Key summary:
  210.   ~~~~~~~~~~~~
  211.  
  212.                  F1 - This Screen
  213.                  F2 - Save font file to disk (fnt)
  214.                  F3 - Erase current character
  215.            Shift+F3 - Fill current character
  216.             Ctrl+F3 - Toggle current character
  217.                  F4 - Create Device Driver for current font
  218.                  F5 - Create TSR for current font
  219.             Ctrl+F5 - Create TSR without initialising font
  220.                  F6 - Create Pascal header file (pas)
  221.                  F7 - Create C header file (c)
  222.                  F8 - Create Assembler header file (asm)
  223.                  F9 - Get system character (for current character)
  224.            Shift+F9 - Get complete system font
  225.             Ctrl+F9 - Get character from alternative font
  226.                 F10 - Load font file (fnt)
  227.            Ctrl+F10 - Load alternative font
  228.                 ESC - Exit to DOS
  229.                   C - Copy character to buffer
  230.                   P - Paste character from buffer
  231.                   H - Flip character horizontally.
  232.                   V - Flip character vertically.
  233.   
  234.  
  235.    Shift+Arrow keys - Scroll character around the edit window
  236.   
  237.   
  238.   Other Stuff
  239.   ~~~~~~~~~~~
  240.   
  241.   The file format is simply 16 bytes for each character, which is made  up
  242.   from  the  bit pattern in binary. Each font file should always  be  4096
  243.   bytes in size, and each character has 16 bytes.
  244.   
  245.   The headers that can be created are for including into your own programs
  246.   if  you  want  to  customise  the font, the assembler  code  might  need
  247.   changing  to  meet  your requirements. The TSR and  device  driver  will
  248.   prevent  the  font  reverting back to the  original  VGA  card  font  by
  249.   installing  itself  on interrupt 10, although one or two  programs  will
  250.   still  get rid of it, I have only found two :- 'Carbon Copy', and  'More
  251.   Fonts', however I am sure there others. Some programs will lose the font
  252.   when switching to and from different graphics/text modes, but it usually
  253.   gets  restored when the program is exited. The TSR & Device Driver  only
  254.   requires a modest bit of memory (about 4k), and can be loaded high  with
  255.   no problems, I haven`t had it cause any conflicts with anything (yet !).
  256.   Thanks  to Gary Anderson for  helping me  with the initial TSR  and  the
  257.   system font.
  258.